home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / os2 / pmftrm.zip / PMFTERM.HLP (.txt) < prev    next >
OS/2 Help File  |  1992-06-04  |  26KB  |  814 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About PMFTERM Emulation ΓòÉΓòÉΓòÉ
  3.  
  4. PMFTERM is a general purpose terminal emulator for OS/2.  PMFTERM provides 
  5. FTTERM color emulation, as well as DEC VT100, ANSI and line-mode TTY support. 
  6. Support for multiple font sizes, automatic logon keying (Autokeys) as well as 
  7. color selection for FTTERM emulation is provided, as well as screen print, cut 
  8. and paste. 
  9.  
  10. Two file transfer protocols are supported, IND$FILE and XMODEM. File transfers 
  11. can be invoked by pulldown menus or by the command line interface programs 
  12. PSEND and PRECEIVE. 
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ 2. Setting Profiles for PMFTERM ΓòÉΓòÉΓòÉ
  16.  
  17. You can customize any number of emulation profiles for PMFTERM.  These profiles 
  18. are saved in the OS2.INI system file and can be selected by a pulldown menu 
  19. item or by specifying the name of the profile to be used on the PMFTERM command 
  20. line. 
  21.  
  22. The customizable values are: 
  23.  
  24.  Emulation type 
  25.  
  26.  Number of data bits 
  27.  
  28.  Number of stop bits 
  29.  
  30.  Communications port 
  31.  
  32.  File transfer protocol 
  33.  
  34.  Line speed 
  35.  
  36.  Parity 
  37.  
  38.  FTTERM protocol converter type 
  39.  
  40.  FTTERM host type 
  41.  
  42.  Autokey Sequences 
  43.  
  44.  For more information on selecting a terminal profile, see Selecting Profiles. 
  45.  
  46.  
  47. ΓòÉΓòÉΓòÉ 3. About the Autokeys Dialog ΓòÉΓòÉΓòÉ
  48.  
  49. The Logon Key Definitions dialog is used to define a set of keystrokes which 
  50. are to be sent to the host system during initial connect processing.  For each 
  51. "Send" key definition a corresponding "Response" definition must be provided. 
  52. PMFTERM processes the Send and Response entries sequentially until a blank 
  53. entry is found, at which time autokey processing terminates. 
  54.  
  55. During autokey processing a dialog box is display which provides a visual 
  56. indication of the progress of the logon process. 
  57.  
  58. More information may be found in: 
  59.  
  60.  Manual Connect Only 
  61.  
  62.  Entering Autokey Information 
  63.  
  64.  
  65. ΓòÉΓòÉΓòÉ 4. Deleting Profiles ΓòÉΓòÉΓòÉ
  66.  
  67. You may delete individual profiles via the Profile Delete pulldown. You may 
  68. enter the profile to be deleted via the keyboard (case is ignored and is set to 
  69. upper case) or the mouse.  You may select Cancel at any time to abort the 
  70. process. 
  71.  
  72.  
  73. ΓòÉΓòÉΓòÉ 5. Color Selection for FTTERM Emulation ΓòÉΓòÉΓòÉ
  74.  
  75. You may find that it is difficult to see all of the FTTERM colors when working 
  76. with an 8507 monochrome display, a PS/2 Model P70 plasma display or sometimes 
  77. with a PS/2 Model L40SX, depending on the level of the installed display 
  78. drivers.  If this is the case, you can change any or all of the four basic 3270 
  79. data stream colors via the Customize pulldown menu.  If the Colors menu item is 
  80. not selectable, go to the Profiles pulldown and select a terminal profile which 
  81. specifies FTTERMC emulation. 
  82.  
  83. The FTTERM Color Selection dialog box contains a set of radio buttons which 
  84. indicate which of the 4 basic 3270 colors is to be changed, a set of color 
  85. buttons corresponding roughly to the 8 basic AVIO colors and a number of 
  86. pushbuttons at the bottom to control updating and saving of the changes. 
  87.  
  88. To modify a color, push the radio button corresponding to the color to be 
  89. changed (in order they correspond to Green, Red, Blue and White), push the 
  90. button in the "To" group for the new color and then push the "Set" button. 
  91. When all the desired changes have been made, push the "Ok" button to exit the 
  92. dialog.  To write the changes to the OS2.INI file, push "Save". 
  93.  
  94. The "Reset" button will reset the colors to the PMFTERM default colors, but 
  95. will not update OS2.INI unless you select "Save". 
  96.  
  97.  
  98. ΓòÉΓòÉΓòÉ 6. File Transfer ΓòÉΓòÉΓòÉ
  99.  
  100. PMFTERM implements IND$FILE and XMODEM (both checksum and CRC) file transfers. 
  101.  
  102. Because of the differences between the 7171 protocol converter and the 3708, it 
  103. is very important that the Terminal Settings be set to reflect the proper 
  104. machine type.  Also, the TSO/CMS settings must be correct for IND$FILE to work 
  105. correctly. 
  106.  
  107. IND$FILE via Pulldown menus 
  108.  
  109. You can invoke IND$FILE from the File pulldown menu or from the PSEND/PRECEIVE 
  110. commands.  Selecting the File Send or Receive options presents the following 
  111. dialog box. 
  112.  
  113. IND$FILE via PSEND/PRECEIVE 
  114.  
  115. You may also use the PSEND/PRECEIVE commands provided with PMFTERM to invoke 
  116. file transfer from the command line. PSEND/PRECEIVE have identical syntax to 
  117. the the OS/2 CM SEND/RECEIVE commands for IND$FILE. PSEND/PRECEIVE default to 
  118. host session "I" instead of "A". 
  119.  
  120. The PCASSI package from OS2TOOLS provides an excellent interface to the 
  121. standard SEND/RECEIVE commands.  You may use PCASSI in one of two ways with 
  122. PMFTERM.  Either rename the PSEND/PRECEIVE commands to SEND/RECEIVE if you do 
  123. not have any other IBM SEND/RECEIVE command installed on your system, or use 
  124. the PCASSI50.CUS customization file with PCASSI 3.0 or above.  PCASSI50 
  125. customizes PCASSI to use PSEND/PRECEIVE through host session "I".  Refer to the 
  126. PCASSI package documentation for more information. 
  127.  
  128. Recovering from IND$FILE errors 
  129.  
  130. During file transfer (IND$FILE and XMODEM) the following status dialog is 
  131. maintained: 
  132.  
  133. A number of "hangs" can occur during IND$FILE file transfer. In general, the 
  134. problems will occur on file downloads and are caused by parity problems or lost 
  135. characters during the receive operation. PMFTERM will "beep" whenever a parity 
  136. or framing error is detected by the OS/2 COM device driver, and if the host 
  137. screen is not correctly received in 40 seconds will issue the "Host has not 
  138. responded in 40 seconds".  Corrective action for this condition is: 
  139.  
  140.   1. Switch to the host session. 
  141.  
  142.   2. If the host screen is blank, minimize and then maximize the host window. 
  143.      You should see what looks like garbage on the screen. 
  144.  
  145.   3. Hit CTRL-R to reset the keyboard, followed by CLEAR. 
  146.  
  147.  The file transfer should now resume.  You may minimize the PMFTERM window to 
  148.  an icon if you wish.  If the above recovery action does not seem to work, you 
  149.  must abort the file transfer by following these instructions: 
  150.  
  151.   1. First cancel the PMFTERM file transfer interface, either via the "Cancel" 
  152.      button on the Send/Receive dialog or by Ctrl-Break if using 
  153.      PSEND/PRECEIVE. 
  154.  
  155.      Note:  It can take 30-40 seconds to cancel the file transfer, since 
  156.      PMFTERM must wait for host download screens to be completely received in 
  157.      some situations. 
  158.  
  159.   2. If the host "Ready" prompt does not appear in 30-40 seconds, activate the 
  160.      PMFTERM window and Minimize/Maximize it.  You should see some strange 
  161.      looking characters on the screen, or a screen that starts with the 
  162.      character "A", "B", "C" or "<" .  Hit the F2  key. 
  163.  
  164.   3. If the sequence "C???q" appears next, where ??? can be any character, hit 
  165.      the Enter key and the Ready prompt will appear. 
  166.  
  167.  Strange characters during IND$FILE 
  168.  
  169.  PMFTERM disables screen updates during IND$FILE file transfers. However, if 
  170.  you move, resize, minimize/maximize or in any other way cause the PMFTERM 
  171.  window to be altered during transfers you will be regaled with large amounts 
  172.  of what appears to be garbage flowing over your terminal emulation screen. 
  173.  This is normal.  If it bothers you, just minimize the PMFTERM session until 
  174.  the file transfer completes. 
  175.  
  176.  XMODEM File Transfers 
  177.  
  178.  When the Terminal Settings indicate that file transfer is via XMODEM the 
  179.  procedure for file transfer is almost identical to IND$FILE. Selecting the 
  180.  File Send or Receive options presents the following dialog box. 
  181.  
  182.  1K Send will be used if this checkbox is turned on.  You must be certain that 
  183.  the receiving system supports XMODEM CRC with 1K blocks! 
  184.  
  185.  The PSEND/PRECEIVE command interface may still be used.  However, 
  186.  PSEND/PRECEIVE for XMODEM requires that the following syntax be followed: 
  187.  
  188.  PSEND  pcfilename [s:] (X [1K])
  189.  PRECEIVE pcfilename [s:] (X)
  190.  
  191.  The right parenthesis is optional, but the left parenthesis is required. 
  192.  
  193.  The "s" is optional and is the host session ID ("I" is the default). 
  194.  
  195.  The "X" signifies XMODEM and may be in upper or lower case. 
  196.  
  197.  The only command line operand allowed with XMODEM is "1K", which forces 
  198.  PMFTERM into 1024 byte Send mode (instead of 128 byte mode).  If 1K mode is 
  199.  selected, CRC mode is also enforced.  You must be certain that the receiver 
  200.  supports 1024 byte blocks.  Otherwise, the Send operation will be aborted by 
  201.  the receiving system. 
  202.  
  203.  PMFTERM attempts to use XMODEM CRC protocol, but will operate in XMODEM 
  204.  checksum protocol if CRC is not allowed by the other end.  Ten (10) attempts 
  205.  are made at three (3) second intervals to establish CRC mode. After that, 
  206.  Checksum mode is established. 
  207.  
  208.  PMFTERM will accept either 128 byte blocks (CRC or Checksum mode) or 
  209.  alternatively, 1024 (1K) byte blocks for file download.  1K blocks are also 
  210.  referred to by some BBS's as "Y-modem 1K", but in actuality this is really 
  211.  Xmodem 1K with CRC mode. Either CRC or Checksum will be used as defined by the 
  212.  receiver. Also, the line characteristics are set to 8 data bits, 1 stop bit 
  213.  and no parity (8-N-1) for the duration of XMODEM file transfers, and are reset 
  214.  to their original settings upon completion of the transfer. Therefore, you may 
  215.  operate your terminal emulations with 7 data bits and parity enabled and still 
  216.  perform XMODEM transfers. 
  217.  
  218.  The same status dialog is displayed as with IND$FILE during XMODEM transfers. 
  219.  
  220.  
  221. ΓòÉΓòÉΓòÉ 7. Help for Keys ΓòÉΓòÉΓòÉ
  222.  
  223. The keyboard mapping for VT100 and FTTERMC emulation closely follows the FTTERM 
  224. 2.1 keyboard mapping, with a few exceptions made at the request of FORUM 
  225. contributors.  For ANSI and TTY modes the keyboard behaves in the same manner 
  226. as a Teletype KSR 33 (including all CTRL keys). 
  227.  
  228. The "3270" emulations (VT100/FTTERMC) use the following: 
  229.  
  230.  Clear           HOME (All keyboards) 
  231.  
  232.                  PAUSE (Enhanced Keyboard) 
  233.  
  234.  Enter           Right CTRL (Enhanced Keyboard) 
  235.  
  236.                  Pad ENTER (Enhanced Keyboard) 
  237.  
  238.                  ENTER (AT Keyboard) 
  239.  
  240.  Return          ENTER (Enhanced Keyboard) 
  241.  
  242.                  CTRL+ENTER (AT Keyboard) 
  243.  
  244.  Erase EOL       END (All Keyboards) 
  245.  
  246.  PF1-PF12        F1-F12 (Enhanced Keyboard) 
  247.  
  248.                  F1-F10, Shift+F1, Shift+F2 (AT Keyboard) 
  249.  
  250.  PA1             CTRL+F1 or ALT+INS (All Keyboards) 
  251.  
  252.  PA2             CTRL+F2 or ALT+HOME (All Keyboards) 
  253.  
  254.  Reset           CTRL+"R" (3708/7171 Implementation) 
  255.  
  256.  In addition to the 3270 key functions defined above, the following CTRL 
  257.  combinations are implemented in VT100: 
  258.  
  259.  5842 CommandCTRL+N (5842 command mode) 
  260.  
  261.  XON/XOFF  CTRL+S/CTRL+Q (Use with care!) 
  262.  
  263.  SI        CTRL+O 
  264.  
  265.  Break     CTRL+C (Not a line break...send the char.) 
  266.  
  267.  
  268. ΓòÉΓòÉΓòÉ 8. PMFTERM Main Window Help ΓòÉΓòÉΓòÉ
  269.  
  270. This is the help for the pmfterm main window. 
  271.  
  272.  
  273. ΓòÉΓòÉΓòÉ 8.1. File Menu Pulldown ΓòÉΓòÉΓòÉ
  274.  
  275. This pulldown control file Send and Receive operations.  The protocol to be 
  276. used for the file transfer is defined in the current terminal settings profile. 
  277.  
  278. For more information, refer to: 
  279.  
  280.  Setting Profiles for PMFTERM 
  281.  
  282.  File Transfer 
  283.  
  284.  
  285. ΓòÉΓòÉΓòÉ 8.2. Print Screen ΓòÉΓòÉΓòÉ
  286.  
  287. The current screen contents are copied to the Print Manager application default 
  288. queue using a simple ASCII data stream.  Nulls are converted to blanks, 
  289. trailing data is stripped and an ASCII CR/LF sequence is appended to the data. 
  290. No check is made to ensure that the screen is not being updated during the 
  291. screen print. 
  292.  
  293. Note:  This does not imply that LPT1 is the target device! You may have 
  294. assigned some other printer to the default queue in the Print Manager! 
  295.  
  296.  
  297. ΓòÉΓòÉΓòÉ 8.3. Settings Pulldown ΓòÉΓòÉΓòÉ
  298.  
  299. This menu controls the Terminal Settings.  Options are provided to 
  300.  
  301.  Set Up Profiles for PMFTERM 
  302.  
  303.  Delete PMFTERM Profiles 
  304.  
  305.  Initialize OS2.INI to remove ALL PMFTERM Profiles. 
  306.  
  307.  
  308. ΓòÉΓòÉΓòÉ 8.4. Exit PMFTERM ΓòÉΓòÉΓòÉ
  309.  
  310. This option unconditionally exits PMFTERM.  The telephone connection is 
  311. dropped.  You will be given an option to continue PMFTERM execution, or to 
  312. terminate PMFTERM with or without saving the current window position. 
  313.  
  314.  
  315. ΓòÉΓòÉΓòÉ 8.5. Initiate Connection ΓòÉΓòÉΓòÉ
  316.  
  317. You may select one of the following actions: 
  318.  
  319.  Connect   Hang up the telephone and restart the connection.  Execute the 
  320.            autokey sequences if any are defined.  This option must also be used 
  321.            when the Manual Connect option is selected to activate the 
  322.            connection. 
  323.  
  324.  Abort Connect The autokey sequences are aborted.    The connection to the 
  325.            telephone network remains active. 
  326.  
  327.  Hangup.   The telephone is hung up (goes on-hook) at once. 
  328.  
  329.  
  330. ΓòÉΓòÉΓòÉ 8.6. Clipboard Operations ΓòÉΓòÉΓòÉ
  331.  
  332. Standard PM Mark, Copy and Paste functions are provided on the Edit pulldown 
  333. menu item.  Text can be marked with the mouse or via the keyboard.  To mark 
  334. text via the keyboard select Edit Mark.  A selection rectangle will appear 
  335. starting at the current cursor position.  Size the rectangle with the keyboard 
  336. arrow keys and hit Enter to complete the selection process.  If you have 
  337. problems (due to bugs) while marking text, maximize PMFTERM's window and use 
  338. the keyboard instead of the mouse to mark the text.  I have some bugs in this 
  339. area still. Edit Copy or Ctrl+Ins can be used to copy the selected text to the 
  340. clipboard. 
  341.  
  342. You might also occasionally observe that a selection rectangle or small 
  343. cursor-like line appears when switching to PMFTERM from another PM application 
  344. using mouse button 1. If this happens, just hit the left mouse button again 
  345. while in the PMFTERM client window and the selection will be reset. 
  346.  
  347. Paste is activated when the clipboard is found to contain data in the clipboard 
  348. CF_TEXT format.  When you select Edit Paste from the pulldown (or use the 
  349. Shift+Ins key combination) the contents of the clipboard are typed into the 
  350. host session, starting at the cursor location.  Depending on the emulation in 
  351. effect the data is translated to match the behavior of the keyboard, for 
  352. example in FTTERMC emulation a 0D "return" character should be treated as a 
  353. "new line" character, but in TTY line mode the 0D should be treated as an 
  354. "enter".  All "new line" 0A characters are ignored by Paste. 
  355.  
  356.  
  357. ΓòÉΓòÉΓòÉ 8.7. Color Selection ΓòÉΓòÉΓòÉ
  358.  
  359. When using FTTERMC emulation it is possible to change the basic 3270 data 
  360. stream colors to make the screen more visible on monochrome and plasma 
  361. displays. 
  362.  
  363. Refer to  Color Selection for FTTERM Emulation General Description and How to 
  364. Select FTTERM Colors for information on how to do this. 
  365.  
  366. Note:  This selection is only applicable to FTTERM emulation. It is not 
  367. possible to change the colors for ANSI emulation. 
  368.  
  369.  
  370. ΓòÉΓòÉΓòÉ 8.8. Font Selection ΓòÉΓòÉΓòÉ
  371.  
  372. PMFTERM will attempt to present the first 16 AVIO (Advanced Video Input Output) 
  373. fonts supported on your particular display via this pulldown. Whenever you 
  374. change the specified font the new setting will be saved in OS2.INI.  In some 
  375. cases (and under OS/2 1.2) PMFTERM will not be able to communicate with the 
  376. display driver.  In this case you will only be given the option of "Large" and 
  377. "Small" EGA fonts, rather than a full selection of all the supported fonts.  In 
  378. that case you will need a new display driver. 
  379.  
  380.  
  381. ΓòÉΓòÉΓòÉ 9. Working with Profiles ΓòÉΓòÉΓòÉ
  382.  
  383. Profiles are saved in OS2.INI.  When a profile is retrieved it replaces the 
  384. in-memory terminal profile.  Unless the manual connect. option is selected the 
  385. current connection is aborted and a new connection is established using the new 
  386. terminal settings and autokeys. If manual connect is selected, only the 
  387. in-memory terminal profile is updated but the connection continues using the 
  388. previous settings. 
  389.  
  390.  
  391. ΓòÉΓòÉΓòÉ 9.1. Profile Name ΓòÉΓòÉΓòÉ
  392.  
  393. This box contains the names of all of the current profiles.    The active profile 
  394. is highlited.  You may select the profile to be used by clicking on the profile 
  395. name with the mouse and then clicking on Retrieve, by using the arrow keys to 
  396. move up and down in the list and then hitting Enter, or by typing the name of 
  397. the desired profile and hitting Enter. 
  398.  
  399. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  400.  
  401.  
  402. ΓòÉΓòÉΓòÉ 9.2. Retrieving a Profile ΓòÉΓòÉΓòÉ
  403.  
  404. This button causes the profile specified in the profile name to be retrieved 
  405. from OS2.INI.  If the specified profile does not exist, the terminal settings 
  406. are set to the PMFTERM default (FTTRMIIN). 
  407.  
  408. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  409.  
  410.  
  411. ΓòÉΓòÉΓòÉ 9.3. Terminal Emulations ΓòÉΓòÉΓòÉ
  412.  
  413.  Emulation Description 
  414.  
  415.  FTTERMC   This is the IBM PC/Host File Transfer Program 3270 emulation 
  416.            protocol.  It is primarily designed for use with the IBM 
  417.            3708/3174AEA and 7171 protocol converters.  The IND$FILE (Release 
  418.            1.1.1) file transfer protocol is supported.  Colors can be remapped 
  419.            to accomodate monochrome and plasma displays.  When working with a 
  420.            3708/3174 it is imperative that the Typeahead and Enhanced 
  421.            Null/Blank options be enabled (the operator information area will 
  422.            show "TYP  N/B".    Toggle this setting with the <ESC>t sequence. 
  423.  
  424.  ANSI      PMFTERM provides ANSI-compatible data stream processing.  All 
  425.            CTRL-key combinations are supported.  ANSI color and cursor 
  426.            positioning data streams are supported.  This emulation is useful 
  427.            for accessing many BBS's.  XMODEM, XMODEM CRC and XMODEM 1K are 
  428.            supported for file transfer. 
  429.  
  430.  VT100     DEC VT100(R) emulation can be used for access to IBM 7171 protocol 
  431.            converters which do not have the FTTERM TDT's installed, as well as 
  432.            for access to any ASCII host supporting VT100 protocol.  Both 
  433.            IND$FILE and XMODEM are supported. 
  434.  
  435.  TTY       Line-mode ASCII emulation is supported for access to ASCII hosts. 
  436.            All CTRL-key combinations are supported, as is XMODEM file transfer. 
  437.  
  438.  For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  439.  
  440.  
  441. ΓòÉΓòÉΓòÉ 9.4. Line Speeds ΓòÉΓòÉΓòÉ
  442.  
  443. You may select line speeds of 300, 1200, 2400, 4800, 9600 and 19,200 BPS.  The 
  444. PC/AT does not support speeds of 19,200 and damage to the serial adapter may 
  445. result if it is operated at this speed. Although PMFTERM may work with MNP 
  446. modems using compression, it is recommended that for the full-screen (FTTERMC, 
  447. ANSI and VT100) emulations compression be disabled. 
  448.  
  449. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  450.  
  451.  
  452. ΓòÉΓòÉΓòÉ 9.5. Parity Selection ΓòÉΓòÉΓòÉ
  453.  
  454. Select Even, Odd or None for parity.  Regardless of the selection PMFTERM will 
  455. revert to None for the duration of XMODEM file transfers, and then restore the 
  456. user-selected parity at the completion of the file transfer. 
  457.  
  458. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  459.  
  460.  
  461. ΓòÉΓòÉΓòÉ 9.6. Setting the Data Bits ΓòÉΓòÉΓòÉ
  462.  
  463. Generally, 7 data bits will be selected for FTTERM and VT100.  7 or 8 may be 
  464. selected for ASCII hosts.  PMFTERM will switch to 8 data bits during XMODEM 
  465. file transfers and restore the user-selected data bit setting when the transfer 
  466. is complete. 
  467.  
  468. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  469.  
  470.  
  471. ΓòÉΓòÉΓòÉ 9.7. Setting the Stop Bits ΓòÉΓòÉΓòÉ
  472.  
  473. Select 1 stop bit for 1200 BPS and above.  2 stop bits may be used for 300 BPS 
  474. and (sometimes) for 1200 BPS). 
  475.  
  476. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  477.  
  478.  
  479. ΓòÉΓòÉΓòÉ 9.8. Communications Device Number ΓòÉΓòÉΓòÉ
  480.  
  481. COM1-4 may be selected on PS/2 hardware and on some clones when supported by 
  482. OS/2.  PC/AT hardware only supports COM1 and COM2. 
  483.  
  484. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  485.  
  486.  
  487. ΓòÉΓòÉΓòÉ 9.9. File Transfer Protocol ΓòÉΓòÉΓòÉ
  488.  
  489. PMFTERM supports IND$FILE Release 1.1.1 protocol, XMODEM, XMODEM CRC and XMODEM 
  490. 1K file transfer protocols.  Regardless of the user-specified number of data 
  491. bits, stop bits and parity PMFTERM will temporarily switch to 8/1/N during 
  492. XMODEM transfers. 
  493.  
  494. For IND$FILE to work correctly the following options must be set correctly: 
  495.  
  496.  Host System Type 
  497.  
  498.  Protocol Converter Type 
  499.  
  500.  For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  501.  
  502.  
  503. ΓòÉΓòÉΓòÉ 9.10. Host System Type ΓòÉΓòÉΓòÉ
  504.  
  505. The host system (VM/CMS or MVS TSO) must be set here.  This information is used 
  506. during IND$FILE file transfer, and is ignored if XMODEM is set. 
  507.  
  508. To switch from one setting to another during a logon session, ie. through IBM 
  509. Information Network or through multi-session host software you must do the 
  510. following: 
  511.  
  512.   1. Log off the previous host session 
  513.  
  514.   2. Select the Settings pulldown 
  515.  
  516.   3. Change the Host Type to match the new session 
  517.  
  518.   4. Select Keys... 
  519.  
  520.   5. Check the Manual Connect option 
  521.  
  522.   6. Hit OK on the Logon Key Definitions and Terminal Settings screens 
  523.  
  524.  If you are not using the PSEND/PRECEIVE command line interface you may 
  525.  alternatively just change the host type on the IND$FILE file selection dialog 
  526.  window.  This change is only used for the duration of the current file 
  527.  transfer, however. 
  528.  
  529.  For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  530.  
  531.  
  532. ΓòÉΓòÉΓòÉ 9.11. Protocol Converter Type ΓòÉΓòÉΓòÉ
  533.  
  534. For FTTERM emulation, this setting must match the protocol converter being used 
  535. at the host. 
  536.  
  537. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  538.  
  539.  
  540. ΓòÉΓòÉΓòÉ 9.12. Setting a Default Profile ΓòÉΓòÉΓòÉ
  541.  
  542. By checking Default and Save the current terminal settings become the PMFTERM 
  543. defaults.    When you invoke PMFTERM without specifying a profile name the name 
  544. DEFAULT is used for the settings.  If you do not save the current settings this 
  545. checkbox has no effect. 
  546.  
  547. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  548.  
  549.  
  550. ΓòÉΓòÉΓòÉ 9.13. Save the Profile ΓòÉΓòÉΓòÉ
  551.  
  552. The current terminal settings are written to OS2.INI.  If the Default box is 
  553. checked the settings are saved twice, first under the name specified in the 
  554. Profile Name combination box and then under the name DEFAULT 
  555.  
  556. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  557.  
  558.  
  559. ΓòÉΓòÉΓòÉ 9.14. Activate the Profile ΓòÉΓòÉΓòÉ
  560.  
  561. Click on OK to activate the current settings.  Remember to hit the Retrieve 
  562. button if you have just typed a new profile name.  The phone line will be 
  563. dropped and reenabled and the Autokey sequences will be run unless the Manual 
  564. Connect option is selected. 
  565.  
  566. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  567.  
  568.  
  569. ΓòÉΓòÉΓòÉ 9.15. Abort Profile Selection ΓòÉΓòÉΓòÉ
  570.  
  571. The Terminal Settings window is closed and the in-memory terminal settings will 
  572. be reset to their previous state. 
  573.  
  574. For general information on PMFTERM Profiles see Setting Profiles for PMFTERM 
  575.  
  576.  
  577. ΓòÉΓòÉΓòÉ 10. Autokey Definitions ΓòÉΓòÉΓòÉ
  578.  
  579. This dialog is used to define a set of host key sequences which are used during 
  580. Connect processing.  The Logon Key Definition dialog is displayed. 
  581.  
  582.  
  583. ΓòÉΓòÉΓòÉ 10.1. Defining Host Sequences ΓòÉΓòÉΓòÉ
  584.  
  585. Send Definitions 
  586.  
  587. You may enter any valid character in the Send definitions.  Autokey processing 
  588. will complete when an empty Send field is encountered.  Normally you would 
  589. enter modem control sequences, logon information, etc. in the Send fields.  The 
  590. "\" backslash character is used to denote certain escape-type sequences: 
  591.  
  592.  \t or \>  Send a tab sequence to the host 
  593.  
  594.  \d        Send a Ctrl-N (IBM 5841) to the host 
  595.  
  596.  \r        Send a carriage return to the host 
  597.  
  598.  \n        Send a new line to the host 
  599.  
  600.  \c        Send a CTRL-C sequence to the host 
  601.  
  602.  \e        Send an ESC character to the host 
  603.  
  604.  \w        Wait one second 
  605.  
  606.  \<        Send a BACKTAB key (FTTERMC only) 
  607.  
  608.  \\        Send the backslash character 
  609.  
  610.  PMFTERM proceeds sequentially through the autokey sequences until a null entry 
  611.  is found.  For each entry the data in the "Send" field is typed into the 
  612.  emulation session, and PMFTERM waits for the data in the "Response" field to 
  613.  appear in the client window.  If the response information is already on the 
  614.  host screen the scan will be satisfied immediately.  When the data is found, 
  615.  PMFTERM proceeds to the next "Send" item and the process is repeated. 
  616.  
  617.  Response Definitions 
  618.  
  619.  Any ASCII data may be entered into the Response definitions.  Note that the 
  620.  host screen is searched repeatedly for the Response data from row/column 0/0 
  621.  to 24/79.  If the data is found then processing continues with the next Send 
  622.  field.  Residual data on the screen can, therefore, cause a premature exit of 
  623.  the Response search if it satisfies the Response criteria.  Autokey processing 
  624.  completes when an empty Response item is encountered. 
  625.  
  626.  
  627. ΓòÉΓòÉΓòÉ 10.2. Accept Autokey Values ΓòÉΓòÉΓòÉ
  628.  
  629. Selecting OK causes the autokey definitions and the Manual Connect setting to 
  630. be stored in the In-memory profile.  Control is returned to the Terminal 
  631. Settings dialog. 
  632.  
  633.  
  634. ΓòÉΓòÉΓòÉ 10.3. Cancel Autokey Definition ΓòÉΓòÉΓòÉ
  635.  
  636. The in-memory profile image is restored to match its value upon invocation of 
  637. the Logon Key Definitions dialog and control is returned to the Terminal 
  638. Settings dialog. 
  639.  
  640.  
  641. ΓòÉΓòÉΓòÉ 11. Forcing Manual Connection ΓòÉΓòÉΓòÉ
  642.  
  643. This selection will suppress the PMFTERM connect processing which normally 
  644. occurs when OK is selected from the Terminal Settings dialog.  The default 
  645. action is to hang up the telephone, reenable Data Terminal Ready and proceed 
  646. with the autokey processing.  Manual Connection is useful when editing terminal 
  647. settings while a connection is in progress, or for correcting errors in the 
  648. Host type, file transfer protocol, etc. 
  649.  
  650. Warning: PMFTERM frequently refers to the in-memory contents of the Terminal 
  651. Settings during execution.  If you change the Terminal Settings with Manual 
  652. Connect Only set you could cause unpredictable results until you reestablish 
  653. the host connection using the Connect pulldown menu. 
  654.  
  655.  
  656. ΓòÉΓòÉΓòÉ 12. Deleting Individual Profiles ΓòÉΓòÉΓòÉ
  657.  
  658. You may delete an individual profile from OS2.INI by selecting it as described 
  659. in  Specifying the Profile to Delete and then clicking on DELETE. 
  660.  
  661.  
  662. ΓòÉΓòÉΓòÉ 12.1. Specifying the Profile to Delete ΓòÉΓòÉΓòÉ
  663.  
  664. You may select the profile to be deleted via the cursor keys, the mouse or by 
  665. overtyping the name of the profile in the combo box. 
  666.  
  667.  
  668. ΓòÉΓòÉΓòÉ 13. FTTERM Color Selection ΓòÉΓòÉΓòÉ
  669.  
  670. This dialog lets you change the FTTERM colors.  Refer to Color Selection for 
  671. FTTERM Emulation a general description. 
  672.  
  673.  
  674. ΓòÉΓòÉΓòÉ 13.1. Saving the FTTERM Colors ΓòÉΓòÉΓòÉ
  675.  
  676. Clicking on this button will write the current color selection to OS2.INI. 
  677. PMFTERM always attempts to retrieve a color selection set from OS2.INI at 
  678. startup, and if none is found will revert to the initial PMFTERM FTTERM color 
  679. defaults. 
  680.  
  681.  
  682. ΓòÉΓòÉΓòÉ 13.2. Activate the New FTTERM Colors ΓòÉΓòÉΓòÉ
  683.  
  684. The current color selection is activated.  No changes are written to OS2.INI. 
  685. The changes will affect all new output to the screen, so you might wish to 
  686. clear the screen to cause a repaint from the host system to see if the colors 
  687. are what you desire. 
  688.  
  689.  
  690. ΓòÉΓòÉΓòÉ 13.3. Restore PMFTERM Default Colors ΓòÉΓòÉΓòÉ
  691.  
  692. The colors settings are restored to their initial defaults. 
  693.  
  694.  Description                 Color 
  695.  
  696.  Normal Unprotected          Green 
  697.  
  698.  Intensified Unprotected     Red 
  699.  
  700.  Normal Protected            Blue 
  701.  
  702.  Intensified Unprotected     White 
  703.  
  704.  To permanently effect a Reset you must save the FTTERM settings. 
  705.  
  706.  
  707. ΓòÉΓòÉΓòÉ 13.4. Abort Color Change ΓòÉΓòÉΓòÉ
  708.  
  709. The FTTERM color selection is cancelled.  Some of the host colors may have 
  710. already been changed, requiring a Reset or a restart of PMFTERM to restore your 
  711. original color choices. 
  712.  
  713.  
  714. ΓòÉΓòÉΓòÉ 13.5. Using the color buttons for FTTERM ΓòÉΓòÉΓòÉ
  715.  
  716. To change a color: 
  717.  
  718.   1. Select the color to be changed from the choices under Set Color 
  719.  
  720.   2. Select the new color to be assigned to that host attribute (for example, 
  721.      Intensified Unprotected from the choices under To 
  722.  
  723.   3. Select Save 
  724.  
  725.  If you make a mistake, or want to restore the colors to their initial "factory 
  726.  defaults" just select Reset. 
  727.  
  728.  
  729. ΓòÉΓòÉΓòÉ 14. File Selection for File Transfer ΓòÉΓòÉΓòÉ
  730.  
  731. This dialog provides interactive definition of the file transfer parameters for 
  732. IND$FILE and XMODEM.  Use the list boxes or the entry fields to enter the host 
  733. (for IND$FILE) and OS/2 file names, as well as other file transfer options. 
  734.  
  735.  
  736. ΓòÉΓòÉΓòÉ 14.1. OS/2 Filename ΓòÉΓòÉΓòÉ
  737.  
  738. You may overtype the full OS/2 path and file name, or select the file to be 
  739. send/received via the dialog box.  No syntax checking is done if you type the 
  740. file name.  PMFTERM just verifies its existence for Send operations and opens 
  741. it for output for Receive. 
  742.  
  743.  
  744. ΓòÉΓòÉΓòÉ 14.2. Host Filename ΓòÉΓòÉΓòÉ
  745.  
  746. Enter the filename for the host file.  No syntax checking is done to verify 
  747. that the filename is either a valid TSO or CMS file name. 
  748.  
  749. For example, in TSO you must specify the userid prefix and surround the file 
  750. name in apostrophes if PREFIX is on and you want to use a high-level dataset 
  751. name qualifier other than your own userid. 
  752.  
  753.  
  754. ΓòÉΓòÉΓòÉ 14.3. IND$FILE Options ΓòÉΓòÉΓòÉ
  755.  
  756. Check or fill in the following file transfer options: 
  757.  
  758.  RECFM     Host record format, either V, F or U.  This field is not validated 
  759.            and may contain any value to be passed to the IND$FILE command. 
  760.  
  761.            IND$FILE will give a syntax error if this field is present during an 
  762.            attempt at Receiving a file. 
  763.  
  764.  LRECL     This contains the logical record length.  It is limited only by the 
  765.            host operating system and is not checked for validity. 
  766.  
  767.            IND$FILE will give a syntax error if this field is present during an 
  768.            attempt at Receiving a file. 
  769.  
  770.  ASCII     ASCII translation of the data will be done.  IND$FILE's internal 
  771.            translation table will be used.  Codepage and NLS are ignored. 
  772.  
  773.  CRLF      IND$FILE will append a CR and LF sequence to each line of data. 
  774.            ASCII translation is assumed.  This option must be specified 
  775.            correctly in order for the APPEND option to work properly. 
  776.  
  777.  APPEND    The data is appended to the end of the host or OS/2 file.  If the 
  778.            ASCII option is specified during a Receive PMFTERM will check the 
  779.            end of the OS/2 file for an ASCII EOF (hex 1A) and will overlay it 
  780.            if one is found. 
  781.  
  782.  
  783. ΓòÉΓòÉΓòÉ 14.4. Other IND$FILE Options ΓòÉΓòÉΓòÉ
  784.  
  785. Any text entered in this field will be appended to the IND$FILE command. 
  786. PMFTERM will provide parentheses before the other options if needed (ie. host 
  787. type is VM).  No checking is done.  Use this field to specify DASD space 
  788. information, etc. 
  789.  
  790.  
  791. ΓòÉΓòÉΓòÉ 14.5. Host Operating System ΓòÉΓòÉΓòÉ
  792.  
  793. This setting must match the host operating environment.  It is used in 
  794. formatting the IND$FILE command syntax, and by PSEND and PRECEIVE in 
  795. interpreting the command line to ensure the correct file transfer command. 
  796. This selection is initialized to the value from the current terminal profile, 
  797. and may be changed for the duration of a single (menu-driven) file transfer. 
  798.  
  799.  
  800. ΓòÉΓòÉΓòÉ 14.6. OS/2 File Specification ΓòÉΓòÉΓòÉ
  801.  
  802. Use the file selection dialog items to completely specify the name of the OS/2 
  803. file to send or receive.  You may also key the full file specification in the 
  804. PC File area. 
  805.  
  806.  
  807. ΓòÉΓòÉΓòÉ 14.7. Force 1024 XMODEM Block Size ΓòÉΓòÉΓòÉ
  808.  
  809. PMFTERM will accept 1024 byte blocks on all Receive operations.  Since the use 
  810. of 1024 byte blocks is defined by the sender use this selection to tell PMFTERM 
  811. that the receiving host supports 1024 byte blocks. 
  812.  
  813. Note:  Selecting this option on a Send to a host which only supports 128 byte 
  814. XMODEM will result in a file transfer failure.